---
title: superfile 配置
description: 配置你的 superfile
head:
  - tag: title
    content: superfile 配置 | superfile
---

import CodeBlock from '../../../components/code.astro';

你可以使用以下命令编辑你的 superfile 配置文件：

```bash
$EDITOR config_path
```

:::tip
要查看 superfile 文件的路径位置，使用命令 `spf pl`。
:::

### 设置

- ###### 主题

[点击这里](/configure/custom-theme)查看如何编辑主题的说明。

- ###### 编辑器

用于打开文件/目录的编辑器（如果为空，将默认使用 EDITOR 环境变量）。

- ###### 自动检查更新

`true`  => 退出 superfile 时检查是否需要更新（每天只检查一次）。

`false` => 不执行检查。

- ###### 退出时切换目录

:::note
目前在 Windows 上不可用。
:::

`true` => 退出 superfile 时，将终端路径更改为你最后使用的文件面板位置。

`false` => 退出 superfile 时，终端路径保持在使用 superfile 之前的位置。

设置为 `true` 后，你需要更新你的 `.bashrc` 文件。

打开文件：

```bash
$EDITOR ~/.bashrc
```

将以下代码复制到文件中：

<CodeBlock file="cd_on_quit/cd_on_quit.sh" />

保存、退出，然后重新加载你的 `.bashrc` 文件：

```bash
source ~/.bashrc
```

- ###### 默认打开文件预览

`true` => 运行 superfile 时显示文件预览窗口。

`false` => 运行 superfile 时隐藏文件预览窗口。

- ###### 文件大小使用国际单位制

`true` => 使用 1000 的幂显示文件/目录大小（kB、MB、GB）。

`false` => 使用 1024 的幂显示文件/目录大小（KiB、MiB、GiB）。

- ###### 默认目录

每次打开 superfile 时的默认位置。支持 `~` 和 `.`。

- ###### 默认排序类型

文件面板排序类型。目录始终显示在顶部。

`0` => 名称

`1` => 大小

`2` => 修改时间

- ###### 排序顺序反转

文件面板排序顺序。

`false` => 升序（a-z）

`true` => 降序（z-a）

- ###### 区分大小写排序

文件面板排序区分大小写（如果为 `true`，大写字母在小写字母之前）。

`true` => 区分大小写（"B" 在 "a" 之前）

`false` => 不区分大小写（"a" 在 "B" 之前）

### 样式

- ###### 透明背景

`true` => 不渲染背景颜色（透明）。如果你的终端背景是透明的，这很有用。

`false` => 渲染背景（有颜色）以保持主题一致性。

- ###### 文件预览宽度

这个设置是一个整数。

`0` => 文件预览窗口的宽度与文件面板相同。

`X` => 文件预览窗口的宽度是终端宽度（减去侧边栏宽度）的 1/`X`。计算方式为：(终端宽度 - 侧边栏宽度) / `X`

:::caution
`X` 必须在 2 到 10 之间。
:::

- ###### 侧边栏宽度

这个设置是一个整数。

`0` => 不显示侧边栏。

`X` => 侧边栏的宽度。

:::caution
`X` 必须在 3 到 20 之间。
:::

- ###### 边框样式

这里有一些建议的样式，当然你也可以改成你自己喜欢的：

```toml
# ...
border_top = "━"
border_bottom = "━"
border_left = "┃"
border_right = "┃"
border_top_left = "┏"
border_top_right = "┓"
border_bottom_left = "┗"
border_bottom_right = "┛"
border_middle_left = "┣"
border_middle_right = "┫"
#...
```

```toml
# ...
border_top = "─"
border_bottom = "─"
border_left = "│"
border_right = "│"
border_top_left = "╭"
border_top_right = "╮"
border_bottom_left = "╰"
border_bottom_right = "╯"
border_middle_left = "├"
border_middle_right = "┤"
#...
```

### 默认 superfile 配置

<CodeBlock file="src/superfile_config/config.toml" />

